Manual Migration Steps
Make the following changes to your integration to migrate from V1 to V2 authentication:
Request V2 API Credentials
Request new API credentials from the Lightspeed developer portal.
As of November 10, 2025 all newly created API clients are V2 by default. Existing V1 clients will continue to work until applications have been migrated to V2.
Update Client IDs and Secrets
Update your client IDs and secrets to the new V2 API credentials.
Update Authorization and Token URLs
Update the authorization and token URLs in your OAuth2 configuration to the new V2 URLs. Ensure you are using the correct URL for either the trial or production environment.
Update Token Handling Logic
Review and update any logic in your application that handles tokens, including storage, retrieval, and expiration checks, to accommodate the changes in token structure and behavior in V2.
Test the Integration
After making the necessary changes, thoroughly test your integration to ensure that authentication and API requests function as expected under V2 authentication.
Reauthorize Merchant Accounts
Direct merchants to reauthorize in order to generate new access and refresh tokens under V2 authentication.
Update Webhooks and PMS Configurations (if applicable)
If your integration uses Order & Pay webhooks, Item Availability webhooks, or PMS provider configurations, follow the specific migration steps outlined in the Order & Pay Migration Guide and the PMS Migration Guide to update your webhook and PMS configurations for V2 authentication.